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WaveNet:  A  Web-Based  Metocean  Data 
Access,  Processing  and  Analysis  Tool; 

Part  5  -  WW3  Database 

by  Zeki  Demirbilek,  Lihwa  Lin,  Derek  Wilson,  and  Jay  Rosati 

PURPOSE:  This  Coastal  and  Hydraulics  Engineering  Technical  Note  (CHETN)  describes 
coupling  of  the  WAVEWATCH  III  (WW3)  database  to  WaveNet,  the  first  module  of  MetOcnDat 
(Meteorological  and  Oceanographic  Data  or  Metocean  data)  management  and  analysis  system. 
This  Part  5  technical  note  in  the  WaveNet  series  provides  a  step-by-step  procedure  for  users  to 
access,  process,  and  analyze  wave  and  wind  data  from  the  WW3  database. 

BACKGROUND:  U.S.  Army  Corps  of  Engineers  (US ACE)  coastal  modeling  and  planning 
missions  require  metocean  data  (e.g.,  winds,  waves,  tides,  water  levels).  WaveNet  is  a  web-based 
graphical-user-interface  (GUI)  data  management  tool  that  allows  users  to  access,  process,  and 
analyze  wave  and  wind  data  from  different  data  sources.  This  GUI  provides  a  combination  of 
analysis  and  graphical  tools  to  minimize  the  complexity  and  uncertainty  in  data  processing  for 
project  needs.  It  allows  users  to  check  status  of  data  processing,  check  the  availability  of  data,  and 
analyze  quality  and  consistency  of  data.  Users  can  extract,  download,  analyze,  and  prepare  input 
files  for  numerical  wave  models  and  obtain  tabular  and  graphical  information  for  project  planning 
and  reporting  and  further  analysis.  Four  previous  companion  CHETNs  (Wilson  et  al.  2012; 
Demirbilek  et  al.  2013,  2014a,  2014b)  provide  descriptions  and  demonstrations  of  the  WaveNet 
application  to  wave  databases  most  frequently  used  in  the  United  States.  These  earlier  User’s 
Guides  describe  details  of  the  utility  of  WaveNet  with  the  following  databases:  Part  1  for  the 
National  Data  Buoy  Center  (NDBC);  Part  2  for  the  Wave  Information  Study  (WIS);  Part  3  for  the 
Coastal  Data  Information  Program  (CDIP);  and  Part  4  for  the  Great  Lakes  Observing 
System/Coastal  Forecasting  System  (GLOS/GLCFS).  Using  step-by-step  instructions,  this  Part  5 
guide  describes  how  to  access  the  WW3  database  using  WaveNet.  Incorporating  an  example 
application,  it  illustrates  the  processing  and  analysis  of  WW3  data  for  project  planning,  design,  and 
evaluation  studies,  including  how  to  generate  input  files  for  numerical  wave  models. 

WaveNet  employs  a  Google  Map  interface  to  query,  select,  and  display  data  for  a  given 
geographic  region  from  the  different  sources  available.  The  user  may  select  the  date  range  to 
query  the  availability  of  data;  plot,  analyze,  and  extract  data;  postprocess  to  produce  tabular  data 
and  plots  in  a  desired  format;  and  write  input  files  for  numerical  models.  WaveNet  helps  users  to 
obtain  statistical  wave  parameters  such  as  significant  wave  height,  peak  period,  and  direction  and 
generates  wave  and  wind  roses  and  histograms  of  directional  wave  data  required  to  define  the 
wave  climate  for  Corps  projects.  Types  of  outputs  available  in  WaveNet  are  image  files  (*.png), 
portable  document  files  (*.pdf),  Matlab  figures  (*.fig),  text  files  (*.csv  or  *.txt),  and  spectral 
input  files  (*.eng)  for  numerical  models.  Users  can  modify  the  figures  to  view  data  plots  as  well 
as  change  axes  and  labels  or  text  for  project  reports  and  other  publications  as  necessary.  The 
*.eng  is  an  input  file  in  the  format  required  by  numerical  wave  models  CMS-WAVE  and 
STWAVE  (Demirbilek  and  Rosati  2011;  Lin  et  al.  2011a,  b;  Massey  et  al.  2011;  Lin  et  al.  2008). 
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The  WW3  is  the  latest,  most  advanced  numerical  modeling  suite  consisting  of  global  and  regional 
nested  grids  used  by  the  National  Oceanic  and  Atmospheric  Administration’s  (NOAA)  National 
Weather  Service  (NWS)  and  National  Centers  for  Environmental  Prediction  (NCEP).  WW3  is 
used  for  nowcasting  and  forecasting  to  calculate  waves,  currents,  and  other  atmospheric  and 
weather  parameters  in  the  Atlantic  and  Pacific  oceans,  estuaries,  and  Great  Lakes.  The  operational 
ocean  wave  predictions  of  NOAA/NWS/NCEP  use  WW3  with  the  operational  NCEP  products  as 
input  to  provide  estimates  of  conditions  at  the  time  the  model  was  run  to  predict  conditions  into  the 
future.  The  WW3  is  run  four  times  a  day  at  00Z,  06Z,  12Z,  and  18Z.  Each  run  starts  with  9-,  6-  and 
3-hour  (hr)  hindcasts  and  produces  forecasts  of  every  3  hr  from  the  initial  time  out  to  180  hr  (84  hr 
for  the  Great  Lakes).  The  model  results  provide  five  output  variables,  including  significant  wave 
height  in  meters,  wave  period  in  seconds,  wave  direction  in  degrees  (deg),  wind  speed  in  meters 
(m)/sec  and  wind  direction  in  deg,  which  are  accessed  and  used  by  WaveNet.  Additional 
background  information,  references,  and  validation  data  are  available  from  the  WW3  website 
( htty:/ /polar. ncey. noaq. goy/wqves) .  The  following  example  is  designed  to  illustrate  the  use  of 
WaveNet  with  the  WW3  database.  This  is  done  in  a  step-by-step  manner,  with  comments  and 
instructions  to  guide  users,  where  necessary. 

EXAMPLE:  WW3  Data  for  a  Site  in  Hawaii 

Assume  wave  and  wind  data  for  2  months  (1  June  2013  to  30  July  2013)  are  needed  for  a  project 
in  Pacific  Ocean  at  the  20.20N  latitude,  156.94W  longitude.  Project  data  needs  include 
significant  wave  height,  peak  wave  period,  mean  direction,  wind  speed,  and  wind  direction  in 
tabular  form,  as  well  as  wave  and  wind  roses  and  an  *.eng  file  for  CMS-Wave  simulations.  In 
this  example,  it  is  illustrated  how  to  use  WaveNet  to  access  the  WW3  database,  fetch  the  data 
from  the  source,  and  prepare  data  in  the  required  file  formats  for  use  in  project  documents  and  a 
numerical  wave  model. 

Step  1 :  Start  WaveNet.  Click  the  following  link  on  an  ACE-1T  computer  to  start  the  WaveNet 
server  (http: //1 40. 1 94. 1 10.1 68:80()0/GoosleMap3/default/Datamap).  Linder  the  list  of  data 
sources  at  upper  right,  select  WW3.  Use  the  mouse  and  Google  Map  to  move  from  the  WaveNet 
main  page  to  the  Hawaiian  Islands  (Figure  1). 

Step  2:  Select  the  geographic  point  where  data  are  needed.  Zoom  into  the  area  of 
interest  in  Hawaii  (Figure  1)  and  select  the  geographic  location  to  access  the  point-specific  data 
available  from  the  WW3  database.  In  Figure  1,  this  could  have  been  any  point  in  the  water  body 
of  Pacific  Ocean.  The  user  can  select  the  radio  button  below  Click  Point  on  Map  to  Define 
Data  Station  located  at  the  bottom  of  Figure  1  and  then  click  to  a  water  point  in  the  ocean.  The 
coordinates  of  the  point  will  be  displayed  for  the  user  to  adjust,  if  necessary.  WW3  data  can  be 
obtained  from  the  30-minute  or  10-minute  or  4-minute  arc  resolution  grids.  Next,  the  user  can 
specify  the  start  date  (1  Jun  2013)  and  the  end  date  (30  Jul  2013),  choose  metric  or  English  for 
units,  and  then  access  the  data  source.  There  are  two  ways  to  access  the  data  source:  use 
WaveNet  or  go  directly  to  the  database’s  website.  Step  3  describes  these  options. 

Step  3:  Access  data  source.  Click  Retrieve/Plot  Data  located  at  the  bottom  of  Figure  1  to 
use  WaveNet  to  fetch  the  wave  height,  period,  and  direction,  as  well  as  wind  speed  and  direction 
time-series  data  from  the  data  source  for  the  user  to  view  and  process.  Click  on  the  Access  Wave 
Watch  3  Main  Page  link  located  at  the  bottom  of  Figure  1  to  directly  access  the  WW3  website 
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( polar. ncep. noaa. go v/wa ves )  shown  in  Figure  2.  The  user  can  explore  types  of  data  available  and 
download  and  process  data  using  preferred  analysis  programs,  if  so  desired. 


Figure  1 .  Zoomed-in  Hawaii  islands  map  within  WaveNet  user  interface. 


Cl  it*  here  for  the  MMAB  home  page 


MMAB  Operational  Wave  Models 


Product  Product  Product  Model  Model  Data 

Viewer  Table  Descriptions  Description  Access 


NOTICE:  During  the  government  shutdown,  our  branch  server,  polar.ncep.noaa.gov. 
suffered  a  severe  hardware  failure  and  was  taken  off-line  for  repairs.  We  now  have  new 
hardware  in  place,  but  products  are  not  yet  up  to  date.  Additionally,  a  number  of 
archival  products,  such  as  the  wave  model  hindcast  archive,  sea  ice  monthly  analysis 
archive.  Global  RTOFS  graphics  archives,  and  others,  are  missing  or  have  gaps.  We  are 
working  in  getting  all  current  products  up  to  date,  and  badcfilling  the  archive  gaps  as 
much  as  possible. 


The  operational  ocean  wave  predictions  of  NOAA/NWS/NCEP  use  the  wave  model 
WAVEWATCH  III®  using  operational  NCEP  products  as  input  (source  code  is  available). 

The  model  is  run  four  times  a  day:  OOZ,  06Z,  12Z.  and  18Z.  Each  run  starts  with  9-,  6-  and 
3-hour  hindcasts  and  produces  forecasts  of  every  3  hours  from  the  initial  time  out  to  180 
hours  (84  hours  for  the  Great  Lakes). 

The  wave  model  suite  consists  of  global  and  regional  nested  grids.  As  badcground 
information,  a  list  of  selected  references  and  a  chronological  list  of  model  changes  are 
available.  Finally,  validation  data  are  available  for  the  multi-scale  model. 

Archival  Link  to  Legacy  Website  (unsupported). 

rintul  Hurricane  Great  Lakes  Great  Lakes  Global 

010031  Waves  (NAM  winds)  (NDFD  winds)  Ensemble 


WAVEWATCH  III  Regional  Views 


Figure  2.  WW3  website  main  page. 
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Step  4:  Data  display  and  view.  The  slider  bar  shown  at  the  bottom  of  Figure  3  can  be  used  for 
changing  the  data  display  times.  Use  the  calendar  or  the  slider  bar  at  the  bottom  of  the  plot  or  click 
on  the  display  box  to  narrow  the  time  window  of  interest  to  specific  days  or  months.  Double  click 
within  the  start-  and  end-time  boxes  to  get  the  calendar  and  either  type  in  the  Start  and  End  date 
boxes  or  use  the  calendar  to  select  dates  (Figure  3).  The  timeline  plot  will  show  data  availability 
for  wave  height  and  wind  speed,  including  the  data  gaps,  if  any.  To  preview  or  download  the 
selected  station  data,  the  user  may  plot  wave  data  parameters  either  using  the  WW3  website  data 
management  tools  or  WaveNet’s  tools.  In  Figure  3,  a  time  series  of  the  wave  height  and  wind 
speed  is  displayed  for  the  user-specified  time  period.  This  display  uses  WaveNet,  which  provides  a 
unified  platform  for  the  user  to  perform  different  tasks  in  a  consistent  manner  to  avoid  potential 
errors  and  provides  custom  analyses  not  available  from  the  data  sources. 


Download  Data 
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Figure  3.  Time  series  of  wave  height  and  wind  speed  for  user-selected  time  window. 


Step  5:  Download  data  for  project  needs.  Click  on  Tabular  Data  (Figure  3)  to  save  data  in  a 
*.csv  file.  The  “csv”  is  an  ASCII  spreadsheet  with  comma-separated  values  in  text  format.  Table  1 
displays  a  portion  of  a  tabulated  *.csv  data  saved  by  WaveNet.  These  ASCII  data  can  also  be  used 
with  the  Matlab,  Fortran,  Excel,  or  other  software  or  commercial  plotting  packages,  and  with 
numerical  models,  if  desired. 
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Table  1.  Tabulated  data  from  *.csv  file. 
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Step  6:  Wave  roses  and  histograms.  If  the  data  source  does  not  provide  rose  plots  or  histograms, 
users  can  generate  such  plots  using  WaveNet’s  processing  tools.  Click  on  Rose  Plot/Histogram 
below  the  timeline  plot  in  Figure  3  to  generate  rose  plots  and  histograms  of  waves  and  winds  for 
the  segment  of  data  accessed  or  downloaded.  In  rose  plots,  the  percent  occurrence  is  depicted  by 
radial  circles,  and  the  0.5  m  wave  height  bands  are  color  coded  in  the  radial  direction  in 
Figure  4(a).  The  direction  bins  for  waves  approaching  the  shore  are  displayed  in  color  in 
Figure  4(a).  Figure  4(b)  shows  the  wave  histogram  that  illustrates  the  statistical  distribution  of 
wave  height. 

The  rose  plot  and  histogram  for  wind  speed  are  shown  in  Figure  5(a)  and  Figure  5(b),  respectively. 
The  1  m/second  wind  speed  bands  are  color  coded  in  the  radial  direction  (Figure  5(a))  with  percent 
occurrence  shown  by  radial  circles.  Statistical  distribution  of  wind  speed  in  Figure  5(b)  shows  the 
wind  histogram.  The  colored  direction  bins  of  wind  speed  in  Figure  5(a)  represent  the  wind 
approach  angles  to  the  shore. 
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Wave  Rose  for  WW3  20.20N,  156.94W 
2011-06-01  to  2011-07-30 


N50% 


(a) 


Wave  Histogram  for  WW3  20.20N,  156. 94W 
2011-06-01  to  2011-07-30 


(b) 

Figure  4.  Rose  plot  and  histogram  of  wave  heights. 
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Wind  Rose  for  WW3  20.20N,  156. 94W 
2011-06-01  to  2011-07-30 
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(a) 


Wind  Histogram  for  WW3  20.20N,  156. 94W 
2011-06-01  to  2011-07-30 


Wind  Speed  (m/sec) 

(b) 

Figure  5.  Rose  plot  and  histogram  of  wind  speed. 

Step  7 :  Desktop  data  analyses.  After  accessing,  reviewing,  and  downloading  segments  of  data 
from  the  WW3  database  to  a  local  computer  using  WaveNet,  users  can  perform  some  data 
analyses.  For  example,  the  CMS-Wave  and  STWAVE  models  require  an  *.eng  file  for 
directional  wave  input.  If  directional  wave  data  (ID  or  2D  wave  spectra  and  associated  Fourier 
coefficients  used  to  generate  wave  spectra)  are  available  from  the  data  source  sites,  users  may 
download  these  to  their  computers  to  perform  project-specific  postprocessing  analyses.  If  Fourier 
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coefficients  are  not  provided  by  the  data  sources,  the  user  may  perform  these  operations  using 
WaveNet.  Click  on  the  Eng  File  button  located  at  the  bottom  of  the  timeline  plot  shown  in 
Figure  6.  Based  on  the  timeline  selected  by  the  user,  one  or  more  *.eng  file(s)  will  be  generated 
and  listed  beneath  the  time  series  plot,  as  shown  in  Figure  6. 


•Metric  iUTC(QMT)_lJ  waves  ^[height  @period  Indirection 

1  'Englsti  wind  flspeed  Odirecticir 


CMS  Input  Files 


Grid  Orientation  (C artesian) 

Grid  Incident  Boundary  Depth  (m) 

G  LC  FS20 .20  ,-1 56 ,9_20 1 1 06-20 1 1 07  .e  ng 

Figure  6.  Link  to  an  *.eng  input  file  generated  by  WaveNet. 

For  illustration  purposes,  Table  2  displays  a  few  top  lines  of  a  sample  *.eng  file.  Lin  et  al.  (2008, 
2011a)  provide  additional  information  about  the  contents  of  *.eng  files. 


8 


ERDC/CHL  CHETN-IV-103 
February  2015 


Table  2.  Partial  content  of  an  *.eng  wave  input  file 
generated  by  WaveNet. 
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CONCLUSIONS:  This  Part  5  CHETN  in  the  WaveNet  series  describes  the  coupling  of  WaveNet 
with  the  WW3  database  in  order  to  enhance  the  capabilities  of  WaveNet  for  Corps  Districts. 
WaveNet  has  the  ability  to  obtain  project-specific  data  from  the  NOAA/NWS/NCEP  nowcast  and 
forecast  predictions  generated  using  WW3  modeling  suite.  An  example  is  provided  with  a  step-by- 
step  procedure  to  illustrate  how  to  use  WaveNet  to  access  wave  data  from  the  WW3  website  and 
extract  and  analyze  data  for  use  in  coastal  navigation  and  storm  damage  reduction  projects.  This 
user’s  guide  helps  engineers  and  planners  to  obtain  wave  data  for  project  planning,  design,  and 
evaluation  study  reports  and  develop  input  files  for  numerical  wave  models.  As  noted  on  the  WW3 
website,  the  modeling  system  used  to  develop  WW3  data  is  evolving.  Consequently,  WW3  data  in 
the  future  may  also  change  in  content,  complexity,  and  accuracy  of  information.  The  goal  is  to 
enhance  the  capabilities  of  WaveNet  to  help  Districts  obtain  data  from  the  WW3  and  other  data 
sources  which  have  been  integrated  with  WaveNet.  Therefore,  user  feedback  is  crucial  and 
welcome  from  the  USACE  community  for  expanding  and  improving  the  capabilities  of  WaveNet 
for  project  applications.  Also,  users  should  be  aware  of  the  development  of  additional  analysis 
capabilities  for  WaveNet  to  postprocess  wave  and  wind  data  downloaded  by  users.  Description  and 
example  applications  of  these  analyses  will  be  provided  in  the  follow-up  CHETNs  in  this  series. 
Suggestions  are  welcome  from  District  users  about  generic  or  customized  frequency-  and/or  time- 
domain  postprocessing  analyses  and  capabilities  for  different  project  needs. 

POINTS  OF  CONTACT:  This  CHETN  was  prepared  as  part  of  the  Coastal  Inlets  Research 
Program  (CIRP)  and  was  written  by  a  team.  The  POC  for  technical  inquiries  is  Zeki  Demirbilek 
( Zeki.  Dem irbilekCmnsace.  annv.mil) .  For  information  about  CIRP,  please  contact  the  CIRP 
Program  Manager,  Julie  Dean  Rosati  (Julie. D.RosatiCamsace. army.mil) .  This  technical  note 
should  be  referenced  as  follows: 
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Demirbilek,  Z.,  L.  Lin,  D.  Wilson,  and  J.  Rosati.  2015.  WaveNet:  A  web-based 
metocean  data  access,  processing  and  analysis  tool;  part  5-WW3  database. 
ERDC/CHL  CHETN-IV-103.  Vicksburg,  MS:  U.S.  Army  Engineer  Research  and 
Development  Center. 

An  electronic  copy  of  this  CHETN  is  available  from  http: //chi,  erdc.  usace.  army,  mil/chetn. 
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